home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / Inventor / ivfix.z / ivfix
Text File  |  1998-10-30  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4.                                                                       IIIIVVVVFFFFIIIIXXXX((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ivfix - restructures an Inventor object for improved rendering
  10.      performance
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      iiiivvvvffffiiiixxxx [ ----aaaahhhhnnnnttttvvvvVVVV ] [ ----dddd dir ] [infile] [outfile]
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _i_v_f_i_x reads an Inventor object and restructures it to improve the
  17.      object's rendering performance.  _i_v_f_i_x processes the scene graph in two
  18.      phases:
  19.  
  20.      Phase 1)
  21.           Analyzes the organization of the input scene graph, and tries to
  22.           sort it a better way to take advantage of coherence. For example, it
  23.           tries to organize subgraphs by common textures, since switching
  24.           textures is expensive.  Once sorted, it also tries to combine
  25.           subgraphs so that the final result has fewer nodes.
  26.  
  27.      Phase 2)
  28.           "Flattens" the subgraphs that result from the first phase. This
  29.           tessellates all shapes into triangles that are then organized into
  30.           triangle strips.  For example, two spheres may be combined into one
  31.           triangle strip.
  32.  
  33.      WWWWaaaarrrrnnnniiiinnnngggg!!!! _i_v_f_i_x does not try to preserve any non-appearance attributes,
  34.      such as names.  It will also remove most engines, animation nodes, and
  35.      field-to-field connections.  _i_v_f_i_x is best run on individual objects, not
  36.      on entire scenes.  When rendered, the output object will be equivalent to
  37.      the original file, but much of the object hierarchy will be lost.
  38.  
  39.      Note also that the output file may be larger than the input file.  For
  40.      example, a sphere node will be converted into triangle strips.
  41.  
  42.      The following command line options are allowed:
  43.  
  44.      ----aaaa   Write an ASCII file.  The output file is binary by default.
  45.  
  46.      ----dddd ddddiiiirrrr
  47.           Add _d_i_r to the list of directories to search, e.g. for file nodes.
  48.  
  49.      ----hhhh   Print the usage message.
  50.  
  51.      ----nnnn   Do not generate any normals.
  52.  
  53.      ----pppp   ivfix usually tries to define properties as SoVertexProperty nodes.
  54.           This option prevents that.
  55.  
  56.      ----tttt   Do not generate any texture coordinates.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Page 1                           Release 6.5                       August 1991
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. IIIIVVVVFFFFIIIIXXXX((((1111))))
  71.  
  72.  
  73.  
  74.      ----vvvv   (Verbose) Display status information during processing.
  75.  
  76.      ----VVVV   (Very verbose) Display more detailed status information.
  77.  
  78. SSSSOOOOUUUURRRRCCCCEEEE CCCCOOOODDDDEEEE
  79.      Note that the source code to _i_v_f_i_x comes with the _O_p_e_n _I_n_v_e_n_t_o_r _3_d
  80.      _T_o_o_l_k_i_t.
  81.  
  82. FFFFIIIILLLLEEEESSSS
  83.      /usr/share/data/models/* - Sample 3D data files
  84.      /usr/share/src/Inventor/tools/ivfix/* - Source to ivfix
  85.  
  86. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  87.           iiiivvvvffffiiiixxxx <<<< sssslllloooowwwwOOOObbbbjjjjeeeecccctttt....iiiivvvv >>>> qqqquuuuiiiicccckkkkOOOObbbbjjjjeeeecccctttt....iiiivvvv
  88.  
  89. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  90.      inventor, ivview, ivcat, ivinfo, SceneViewer, gview, drop, maze, noodle,
  91.      revo, showcase, textomatic
  92.  
  93. KKKKNNNNOOOOWWWWNNNN BBBBUUUUGGGGSSSS
  94.      Ignore flags are not properly handled.
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Page 2                           Release 6.5                       August 1991
  130.  
  131.  
  132.  
  133.